Function Reference

FileSaveDialog

Initiates a Save File Dialog.

FileSaveDialog ( "title", "init dir", "filter" [, options [, "default name"]] )

Parameters

title	Title text of the Dialog GUI.
init dir	Initial directory selected in the GUI file tree.
filter	File type single filter such as "All (.)" or "Text files (.txt)" or multiple filter groups such as "All (.)\|Text files (.txt)" (See Remarks).
options	[optional] 2 = Path Must Exist (if user types a path, ending with a backslash) 16 = Prompt to OverWrite File
default name	[optional] File name to suggest to the user to save the file with.

Return Value

Success:	Returns the full path of the file chosen. Results for multiple selections are "Directory\|file1\|file2\|..."
Failure:	Sets @error to 1.

Remarks

Separate the file filters with a semicolon as shown in the example.
Multiple groups of filters are separated by a pipe "|".

If default name is given, options must also be given. If none of the options are wanted, use 0 for options.

Special Windows folders (such as "My Documents") can sometimes be set as the init dir; see Appendix.

@WorkingDir is changed on successful return.

Related

FileOpenDialog, FileSelectFolder

Example

$MyDocsFolder = "::{450D8FBA-AD25-11D0-98A8-0800361B1103}"

$var = FileSaveDialog( "Choose a name.", $MyDocsFolder, "Scripts (*.aut;*.au3)", 2)
; option 2 = dialog remains until valid path/file selected

If @error Then
MsgBox(4096,"","Save cancelled.")
Else
MsgBox(4096,"","You chose " & $var)
EndIf

; Multiple filter group
$var = FileSaveDialog( "Choose a name.", $MyDocsFolder, "Scripts (*.aut;*.au3)|Text files (*.ini;*.txt)", 2)
; option 2 = dialog remains until valid path/file selected

If @error Then
MsgBox(4096,"","Save cancelled.")
Else
MsgBox(4096,"","You chose " & $var)
EndIf